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MVC  - Review 


MVC  Seq 

uence 

• User  presses  button,  browser  sends  data 
to  application 

• Controller  receives  the  data,  and  makes 
updates  to  and/or  retrieves  from  the 

Browser 

O sends  request  q 

gets  sent  back 

model  as  necessary 

Model  gamers  data  ' Controller  View 

• User  output  data  is  passed  to  the  View  - 
view  applies  final  look  and  feel  and  the 
response  goes  back  to  the  Brower. 

Business  Logic  and  updates  — Application  Logic  renders — ► Presentation  Logic 
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Time  to  Write  Some  Code 


• Ruby  uses  a pattern  called  “generators” 

• Generators  write  empty  program  elements  for  us  to  extend,  improve 
and  customize 

• This  is  scaffolding  for  new  developers  and  helps  improve  programmer 
productivity  by  automating  common  tasks 

• You  *could*  write  all  this  code  by  hand  - there  is  nothing  magical  in 
the  generators 


The 

Generator 


ruby  script/generate 
shows  help  output 


eee 


Terminal  — bash  — 80x35 


Core:~  scoop$  cd  shove l L 
Core:~/shovel l scoop$  cd  script 
Core:~/shovel l/script  scoop$  ruby  generate 
Usage:  generate  generator  [options]  [args] 


Genera  1 
-P. 
-f, 
-s, 
-q. 
-t, 
-h, 
-c. 


Options: 

— pretend 
— force 
— skip 
— quiet 
— backtrace 
— help 
— svn 


st  be  in  path) 


Run  but  do  not  make  any  changes. 

Overwrite  files  that  already  exist. 

Skip  files  that  already  exist. 

Suppress  normal  output. 

Debugging:  show  backtrace  on  errors. 

Show  this  help  message. 

Modify  files  with  subversion.  (Note:  svn  mu 


Installed  Generators 
Builtin:  controller,  integration. test , 
old,  session.migration,  web.service 


mailer,  migration,  model,  plugin,  scaff 


More  are  available  at  http://rubyonrai ls.org/show/Generators 

1.  Download,  for  example,  login_generator.zip 

2.  Unzip  to  directory  /Users/mattymcg/.rai l s/generators/ login 
to  use  the  generator  with  all  your  Rails  apps 

or  to  /Users/mattymcg/shovel l/generators/login 
to  use  with  this  app  only. 

3.  Run  generate  with  no  arguments  for  usage  information 

generate  login 

Generator  gems  are  also  available: 

1.  gem  search  -r  generator 

2.  gem  install  login_generator 

3.  generate  login 

Core:~/shovel l/script  scoop$  | 


Making  a Controller 


Name  the  controller  Story 

/ 

ruby  script/generate  controller  Story  index 


Make  a controller 


\ 

Add  action  named  index  (default) 


eee 

Terminal  — bash  — 80x24 

Core:~  scoopt  cd  shove ll 

Core: -/shove ll  scoop$  ruby  script/generate  controller  Story  index 

exists 

app/control lers/ 

exists 

app/helpers/ 

create 

app/vievs/story 

exists 

test/f unctiona 1/ 

create 

app/contro  l lers/story_contro 1 1 er .rb 

create 

test/f unctiona l /story _contro l ler_test .rb 

create 

app/he l pers/story_he l per . rb 

create 

app/views/story/i ndex . rhtm l 

Core: -/shove ll  scoop$  | 
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Controller  Files 


• story_controller.rb  - The  controller  itself  with  a skeleton  controller 
inside 

• story_controller_test.rb  - A blank  placeholder  for  tests  you  might 
build 

• story_helper.rb  - A blank  place  for  helper  code 

• index.rhtml  - Your  view  file  with  a skeleton  view  inside 


Scaffolding  Controller  and  View 

app/controllers/story_controller.rb 

class  StoryController  < ApplicationController 
def  index 
end 
end 

app/vi  ews/sto  ry/i  n dex.  rhtm  I 
<h  I >Story#index</h  I > 

<p>Find  me  in  app/views/story/index.rhtml</p> 


http://localhost:3000/story 

[ « ► |[  C | +J  |f*http://localhost:3000/story 

Story  #index 

Find  me  in  app/vicws7story/indcx  rtitml 

The  controller  is  the 
second  element  of  the 
Url. 

The  scaffolding  produces  a 
complete,  functional,  but 
trivial  application. 


ruby  script/generate  model  Story 


000 

Terminal  — bash  — 78x13 

Core: -/shovel l scoop$  ruby  script/generate  model  Story 

E 

exists 

app/models/ 

exists 

test/unit/ 

exists 

test/fixtures/ 

create 

app/mode l s/story .rb 

create 

test/un i t/story_test . rb 

create 

test/f i xtures/stor i es . ym  l 

create 

db/migrate 

create 

db/m i grate/601_create_stor i es . rb 

Core : -/shove l l scoop$  | 

0 

A 

▼ 

Model  Files 


• story.rb  - The  definition  of  the  class  that  is  the  model  that  we  use  in 
Rails  - it  contains  “Story”  which  we  access  in  x = Story.c reate () 

• story_test.rb  -A  place  to  put  our  code  to  test  our  model 

• stories.yml  - A way  to  pre-populate  data  in  database  tables  - primarily 
used  for  testing 

• 00  l_create_stories.rb  - A “migration”  - this  defines  a table  structure 
in  the  database  - later  migrations  can  evolve  the  table  structure  as 
new  fields  are  added  or  other  structure  changes  are  made 


Yet  Another  Markup  Language 


• A way  to  make  objects 
and  set  properties  on 
those  objects. 

• Without  using  XML  :) 

• Primary  use  is  ot  pre- 
populate your  database 
tables  when  building 
unit  tests 


stories.yml 

# set  initial  values  for  the  stories  table 
first: 
id:  I 

name:  My  shiny  weblog 
link:  http://poocs.net/ 
another: 
id:  2 

name:  SitePoint  Forums 

link:  http://www.sitepoint.com/forums/ 


* Also  a play  on  words  - yml  comes  after  xml 


Migrations 


• The  concept  of  a table  structure  that 
evolves  over  time 

• Version  0 - no  table  at  all 

• Version  I -The  first  version 

• Version  2 - Making  some  changes 


http://www.youtube.com/watch?v=n  I NVfDIU6yQ 


00 1 create  stories.rb 


• self_up  method  - what 
to  do  to  go  from 
version  0 to  version  I 

• self_down  - what  to  do 
to  go  from  version  I to 
version  0 

• When  there  is  more 
than  on  migration,  they 
get  chained  together  in 
numeric  order 


class  CreateStories  < ActiveRecord::Migration 
def  self.up 

create_table  :stories  do  |t| 
t.column  :name,  :string 
t.column  : I i n k,  :string 
end 
end 

def  self.down 
drop_table  :stories 
end 
end 


Causing  Migrations  to  Happen 


• rake  db: migrate 

• Evolve  the  database  from  current  version  to  highest  version 

• rake  db:migrateVERSION=0 

• Evolve  from  the  current  version  down  to  zero  - generally  no 
database  at  all. 

Note  - The  text  is  wrong  - you  don’t  need  a before  VERSION 


After  rake  db: migrate 


class  CreateStories  < ActiveRecord::Migration 
def  self.up 

create_table  : stories  do  |t| 
t.column  :name,  :string 
t.column  : I i n k,  :string 
end 
end 

def  self.down 
drop_table  :stories 
end 
end 


0 0 0©SQLite  Database  Browser  - /Users/csev/rails_apps/assn3-soluti...  CD 
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Step  By  Step  - Database  Setup 


• Make  your  model  - ruby  script/generate  model  Story 

• Edit  your  migration  file  - add  columns  - OOI_create_stories.rb 

• Run  rake  db: migrate 

• Check  your  database  in  SQLite  Browser 
• \db\development.sqlite3 

• The  model  is  now  ready  to  use  in  Rails  once  you  restart  your  server 
with  ruby  script/server 


SQLite  Browser  Tips 

• Make  sure  you  are  opening  the  right  file  - when  you  are  switching 
between  projects  you  may  be  looking  at  the  wrong  database 

• To  see  new  information  in  the  browser  - re-open  the  file 

• If  you  make  a change  in  the  browser  without  saving  the  file  will  be 
locked  and  Rails  will  be  unhappy 

• You  *can*  make  changes  in  the  browser  - just  press  save  afterwards  - 
for  example  - you  can  delete  a record  in  the  browser  to  test  add  over 
and  over 


The  Rails  Application  Console 

$ ruby  script/console 
Loading  development  environment. 
» i = 1 
=>  1 

• Like  Interactive  Ruby  (irb)  but 

with  the  Action  Record  models 

» i = i + 1 

loaded  and  ready  to  use  - it  is 

=>  2 

equivalent  to  being  in  a 

» s = Story.new 

Controller  method  - but 

=>  #<Story:0x3355388 

interactive 

@new_record=true, 

@attributes={"name"=>"NULL", 

"link"=>"NULL"}> 

» 

Making  Models  by  Hand 


$ ruby  script/console 

Loading  development  environment. 

» s = Story.new 

=>  #<Story:0x285 7 1 8c 

@new_record=true, 

@attributes={"name"=>nil, 

"link"=>nil}> 

>>  s.name  = 'My  shiny  weblog' 

=>  "My  shiny  weblog" 

» s.link  = 'http://poocs.net/' 

=>  "http://poocs.net/" 

» s.save 
=>  true 


» s.id 
=>  I 

» s.new_record? 

=>  false 

» Story.c  reate  ( 

:name  =>  'SitePoint  Forums', 

:link  =>  'http://www.sitepoint.com/forums/') 

=>  #<Story:0x279d474  @new_record=false, 
@errors=#<ActiveRecord::Er 
rors:0x279c72c  @errors={},  @base=#<Story: 
0x279d474  ...»,  @attribu 
tes={"name"=>"SitePoint  Forums",  "id"=>2, 
"link"=>"http://www.site 
point.com/forums/"}>  Lenz- 1 28 


Retrieving  Models 


» Sto  ry.fi  nd  (2) 

=>  #<Story:0x2796ca0  @attributes={"name"=>"SitePoint  Forums", 
"id"=>"2",  "link,,=>"http://www.sitepoint.com/forums/,l}> 

» Sto ry.fi nd (rail) 

=>  [#<Story:0x2788f9c  @attributes={"name"=>"My  shiny  weblog", 
"id"=>"  I ",  "link"=>"http://poocs.net/"}>,  #<Story:0x2788e70 
@attributes={"name"=>"SitePoint  Forums",  "id"=>"2", 
"link"=>"http://www.sitepoint.com/forums/"}>] 

» Sto  ry.fi  nd  (rail),  last 

=>  #<Story:0x277f80c  @attributes={"name"=>"SitePoint  Forums", 
"id"=>"2",  "link"=>"http://www.sitepoint.com/forums/"}> 
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Sorting  and  Retrieving  by  name 


>>  Sto  ry.fi  nd(:first,  rorder  =>  'id  DESC') 

=>  #<Story:0x2779 1 00  @attributes={"name"=>"SitePoint  Forums", 
"id"=>"2",  "link"=>"http://www.sitepoint.com/forums/"}> 

>>  Story.fi nd_by_name('My  shiny  weblog') 

=>  #<Story:0x2773bd8  @attributes={"name"=>"My  shiny  weblog", 
"id"=>"  I "link"=>"http://poocs.net/"}> 
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Updating  the  Database 


>>  s = Story.fi nd_by_name(' My  shiny  weblog') 

=>  #<Story:0x272965c  ...> 

» s.name 

=>  "My  shiny  weblog" 

» s.name  = 'A  weblog  about  Ruby  on  Rails' 

=>  "A  weblog  about  Ruby  on  Rails" 

» s.save 
=>  true 

» s.update_attribute  :name,  'A  weblog  about  Ruby  on  Rails' 
=>  true 
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Deleting  Records 


>>  s = Story.fi nd_by_name(' My  shiny  weblog') 
=>  #<Story:0x272965c  ...> 

» s.name 

=>  "My  shiny  weblog" 

» s.destroy 

=>  #<Story:0x272965c  ...> 
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eee 


Terminal  — bash  — 119x26 


SOL  (0.081421^ 
S»  (R-WH17?) 
SOL  (0.001894) 
SOL  (0.064846) 

SOL  (0.88443*0 
Story  Coll  I 


SELECT  version  FROM  scheaa.info 

SELECT  * FROM  schema. info 

SHOW  TABLES 

SHOW  FIELDS  FROM  stories 

SHOW  KEYS  FROM  stories 

SHOW  FIELDS  FROM  stories 


SQL  (0-015294) 

SOL  (8.866228') 

SOL  (6.0BB747) 

SOL  CO. 801369) 

SOI  (0.001114) 

SOL  (B .881174) 

SOL  (8.837889) 

Story  Load  (8.533204) 

Story  Lood  (0.613437) 

Story  Load  (8.012962) 

Story  Lood  (0.002186) 

Story  Load  (0.012872) 

SQL  (0.661156)  BEGIN 

Story  Destroy  (0.528325 

WIRE  id  = 1 


'link')  VALUES('Hy  shiny  weblog',  'http://poocs.net/') 


link')  VALUES( ’SitePoint  Forums’,  'http://www.sitepoint.com/forums/ ') 


BEGIN 

INSERT  INTO  stories  (' 

COMMIT 

BEGIN 

INSERT  INTO  stories  ('name' 

mm  n 

SELECT  count(*)  AS  count.all  FROM  stories 

SELECT  * FROM  stories  WWRE  (stories. id  = 2)  LIMIT  1 

SELECT  * FROM  stories 

SELECT  * FROM  stories 

SELECT  * FROM  stories  ORDER  BY  id  DESC  LIMIT  1 

SELECT  * FROM  stories  WERE  (stories . rme ' = 'My  shiny  weblog*  ) LIMIT  1 
DELETE  FROM  stories 


SOL  (8.001247)  COMMIT 

SELECT  * FROM  stories  WWRE  (stories.  r»e'  = *Hy  shiny  weblog1  ) LIMIT  1 

Story  Lood  LB. 912669)  SELECT  * FROM  stories  WHERE  (stories. id  = 1)  LIMIT  1 
Core:~/shovel l/log  scoop$  | 


0 


▲ 

▼ 
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Summary 


• Generating  a Model 

• Building  a Migration 

• Using  the  Rails  console 

• Note:  Ignore  Scaffolding 


